CD ROM Paradise Collection 4/CD ROM Paradise Collection 4 1995 Nov.iso/database/arv134e.zip/ARV.HLP

Text File | 1994-12-16 | 52KB | 1,487 lines

@FilesGesamt
°Marking files:~

Y        \mark file~, or unmark if already marked.

CTRL-Y,  as Y, but works on this file and all files linked to it.
<Space>

-        \unmark~ all files

H        \view list of marked files~
CTRL-H   \retrieve marked files~
         With this function, you can copy ARVed files to where
         you want to.

If you want to move marked files to other groups, you
should use \H~ to jump to the "marked files list", hit \A~ for
the special functions menu, and choose "retrieval and deletion of
marked files". You can then re-add these files to ARV as if they
were new.

°Cursor movement:

Alt-a to Alt-z  jumps to the first file whose first letter is this one...
CTRL-PgUp       jumps to the first file (top of the list)
CTRL-PgDn       jumps to the last file (bottom of the list)

°Function keys, special functions:

#        Change \information~ displayed in the info-line just below the
         list display.

F2       view \statistics~

F3       \ARV configuration~.
         Not all options can be changed there.
         There are more. Please consult ARV.DOK for a full listing.

CTRL-F1  \identify disk~ - Display the ARV ID of any disk

CTRL-F8  \Special functions:~
         - Swapping files function
         - MarkByMail - function
         - Unset "MARKED" flag for all files
         Appropriate help is available using F1 at any time.

CTRL-F10 \Special functions:~
         - Delete file from ARV without requesting disk

°Create/Undo file linkage:

P        select \primary file~

CTRL-V   \link file~ to primary file (the one you selected using P)
CTRL-U   \unlink file~


°Misc:


Shift-   toggle whether to display files that are linked to another
<Tab>    but are not "primary". Thus, from a bunch of files linked
         together, you can only see the "primary" one.
<Tab>    switches display between "comments" and "size etc". Try it.

X        \Search~ for string in file names and comments
         You may use "wildcards":
          ? represents a single character
          * represents any number of characters.

CTRL-X   \continue search~

CTRL-S   or F9 : jump to \DOS-Shell~. Use "exit" to return to ARV.

CTRL-Q   Quick Quit ARV

@FilesGrp
°Marking files:~

Y        \mark file~, or unmark if already marked.

CTRL-Y,  as Y, but works on this file and all files linked to it.
<Space>

-        \unmark~ all files

H        \view list of marked files~
CTRL-H   \retrieve marked files~
         With this function, you can copy ARVed files to where
         you want to.

If you want to assign marked files to other groups, you
should use \H~ to jump to the "marked files list", hit \A~ for
the special functions menu, and choose "retrieval and deletion of
marked files". You can then re-add these files to ARV as if they
were new.

°Cursor movement:

Alt-a to Alt-z  jumps to the first file whose first letter is this one...
CTRL-PgUp       jumps to the first file (top of the list)
CTRL-PgDn       jumps to the last file (bottom of the list)

°Function keys, special functions:

#        Change \Information~ displayed in the info-line just below the
         list display.

F2       view \statistics~

F3       \ARV configuration~.
         Not all options can be changed there.
         There are more. Please consult ARV.DOK for a full listing.

CTRL-F1  \identify disk~ - Display the ARV ID of any disk

CTRL-F8  \Special functions:~
         - Swapping files function
         - MarkByMail - function
         - Unset "MARKED" flag for all files
         Appropriate help is available using F1 at any time.

CTRL-F10 \Special functions:~
         - Delete file from ARV without requesting disk

°Create/Undo file linkage:

P        select \primary file~

CTRL-V   \link file~ to primary file (the one you selected using P)
CTRL-U   \unlink file~


°Misc:


Shift-   toggle whether to display files that are linked to another
<Tab>    but are not "primary". Thus, from a bunch of files linked
         together, you can only see the "primary" one.
<Tab>    switches display between "comments" and "size etc". Try it.

X        \Search~ for string in file names and comments
         You may use "wildcards":
          ? represents a single character
          * represents any number of characters.

CTRL-X   \continue search~

CTRL-S   or F9 : jump to \DOS-Shell~. Use "exit" to return to ARV.

CTRL-Q   Quick Quit ARV

@FilesDisk
°Marking files:~

Y        \mark file~, or unmark if already marked.

CTRL-Y,  as Y, but works on this file and all files linked to it.
<Space>

-        \unmark~ all files

H        \view list of marked files~
CTRL-H   \retrieve marked files~
         With this function, you can copy ARVed files to where
         you want to.

If you want to move marked files to other groups, you
should use \H~ to jump to the "marked files list", hit \A~ for
the special functions menu, and choose "retrieval and deletion of
marked files". You can then re-add these files to ARV as if they
were new.

°Cursor movement:

Alt-a to Alt-z  jumps to the first file whose first letter is this one...
CTRL-PgUp       jumps to the first file (top of the list)
CTRL-PgDn       jumps to the last file (bottom of the list)

°Function keys, special functions:

#        Change \Information~ displayed in the info-line just below the
         list display.

F2       view \statistics~

F3       \ARV configuration~.
         Not all options can be changed there.
         There are more. Please consult ARV.DOK for a full listing.


CTRL-F1  \identify disk~ - Display the ARV ID of any disk

CTRL-F8  \Special functions:~
         - Swapping files function
         - MarkByMail - function
         - Unset "MARKED" flag for all files
         Appropriate help is available using F1 at any time.

CTRL-F10 \Special functions:~
         - Delete file from ARV without requesting disk

°Create/undo file linkage:

P        select \primary file~

CTRL-V   \link file~ to primary file (the one you selected using P)
CTRL-U   \unlink file~


°Misc:


Shift-   toggle whether to display files that are linked to another
<Tab>    but are not "primary". Thus, from a bunch of files linked
         together, you can only see the "primary" one.
<Tab>    switches display between "comments" and "size etc". Try it.

X        \Search~ for string in file names and comments
         You may use "wildcards":
          ? represents a single character
          * represents any number of characters.

CTRL-X   \continue search~

CTRL-S   or F9 : jump to \DOS-Shell~. Use "exit" to go back.

CTRL-Q   Quick Quit ARV

@Gruppen


\                         ▄█ ██████████████▄   ███████      ▄███████▀
\                       ▄███ ████████████████  ███████    ▄███████▀
\                     ▄█████ ▀▀▀▀▀▀▀▀▀████████ ███████  ▄███████▀
\                   ▄███████           ███████ ███████▄███████▀
\                 ▄█████████          ▄██████  █████████████▀
\               ▄███████████ ██████████████▀   ███████████▀
\             ▄█████████████ ██████████████▄   █████████▀
\           ▄███████▀███████ ▀▀▀▀▀▀▀▀▀███████  ███████▀
\         ▄███████▀  ███████           ███████ █████▀
\       ▄███████▀    ███████           ███████ ███▀
\     ▄███████▀      ███████           ███████ █▀      °The Archiver


                Dirk Wriedt, Kirsebek 15, D-24376 Kappeln, Germany
             email : [e-mail]   Fido 2:240/2120.8


°If you are new to ARV,
you may ask yourself what you can do now. Please look at the end of this
help text.

°Special functions:

F2       view \statistics~

F3       \ARV configuration~.
         Not all options can be changed there.
         There are more. Please consult ARV.DOK for a full listing.


CTRL-F1  \identify disk~ - Display the ARV ID of disk in drive


CTRL-F10  add a whole disk to the actual group

°Misc:

+         Begin \addition~ of new files to the ARV catalog

CTRL-D    \print~ this list

CTRL-S    or F9 : jump to \DOS-Shell~. Use "exit" to return to ARV.

CTRL-Q    \Quick Quit~ ARV
<Esc>     Leave ARV

N         create \new group~
L         \delete group~. You can only delete empty groups.

P         \Change ARV - partition~.
          Registered version only.
          Select *.AR? files. x=V for the basic partition,
                              x=1..9 for optional additional partitions.
          Seek ARV.DOK for info.
          Use ARV /<No> to select partition when running ARV.

Alt-a to Alt-z jumps to first group whose name begins with letter.

CTRL-PgUp       jumps to first group
CTRK-PgDn       jumps to last group

°Hints for new users:

Use "\N~" to create groups to distribute your tools/pictures/other files
amongst. The name of the group should reflect a special topic the files
in this group refer to. For example, create groups named like

        "FAQs from Usenet"
        "Pictures of animals"
        "Games"
        "Disk copy tools"
        "Archiving tools"
etc.

Use "\+~" to start adding files to the ARV catalogue system. That
is very easy, as ARV always tells you what to do. You don't have
to create some groups first, that can be done during the addition
process. Try it now. You will need some empty disks.
@DisksGesamt

°Special functions:

CTRL-F1  \identify disk~ - Display the ARV ID of disk in drive

CTRL-F10  \Special functions~
          - Re-read free space of disk
          - Remove Disk from ARV
          - Re-write comments to disk
          - Lock/Unlock Disk
          - Verify Disk Data with ARV catalog data
          - Write DISK.ID for actual disk to any path

°Disk - flags

What is the meaning of the letters that may appear in this list
to the very right of each line?

┌──────────────┐
│ Disk - flags │
└──────────────┘

 "S" : This disk is locked and no more files will be put on it.
       Use CTRL-F10 to Lock/Unlock a disk.

 "K" : This flag is only used when describe_arv is set to "ja",
       "yes" or "on."
       It is set automatically when a comment to a file residing
       on this disk is being changed.
       The next time the disk happends to be accessed by ARV, the
       comments are updated. Use CTRL-F10 to do this manually.

°Misc:

L         \Remove disk\ from ARV. The DISK.ID will be removed.
          This only works on empty disks.
F2        view \statistics~
F3        \ARV-configuration~. Consult ARV.DOK!
CTRL-D    \print~ this list
CTRL-S    or F9 : jump to \DOS-Shell~, use "exit" to return to ARV.

CTRL-Q    \Quick Quit~ ARV.

Alt-a to Alt-z  jump to the first disk whose name begins with letter...
CTRL-PgUp       jumps to first disk
CTRL-PgDn       jumps to last disk
@DiskGrp

°Disk - flags

What is the meaning of the letters that may appear in this list
to the very right of each line?

┌──────────────┐
│ Disk - flags │
└──────────────┘

 "S" : This disk is locked and no more files will be put on it.
       Use CTRL-F10 to Lock/Unlock a disk.

 "K" : This flag is only used when describe_arv is set to "ja",
       "yes" or "on".
       It is set automatically, when a comment to a file residing
       on this disk is being changed.
       The next time the disk happends to be accessed by ARV, the
       comments are updated. Use CTRL-F10 to do this manually.


°Misc:

F2        view \statistics~
F3        \ARV-configuration~. Consult ARV.DOK!
CTRL-D    \print~ this list
CTRL-S    or F9 : jump to \DOS-Shell~, use "exit" to return to ARV.

CTRL-Q    \Quick Quit~ ARV.

Alt-a to Alt-z  jump to the first disk whose name begins with letter...
CTRL-PgUp       jumps to first disk
CTRL-PgDn       jumps to last disk

°Special functions:

CTRL-F1  \identify disk~ - Display the ARV ID of disk in drive

CTRL-F10  \Special functions~
          - Re-read free space of disk
          - Remove Disk from ARV
          - Re-write comments to disk
          - Lock/Unlock Disk
          - Verify Disk Data with ARV catalog data
          - Write DISK.ID for actual disk to any path
@NeuAufnahme
°Basic functions :

<Ende>    \finish selection, start copying~

A..H      \choose drive~
CTRL-B    \edit file comment~
          NOTE: The comment is not yet written to the descript.ion-file.
CTRL-D    Write actual file comments to \4DOS-description-file~.
          This way, you will not lose the comments when quitting ARV.
K         If you have specified files_bbs-files or an afx_verz-directory
          in ARV.CFG, this key will search for a \file comment~ for the
          file under the cursor.
CTRL-K    as for K but searches for comments for all marked files.
          The K and CTRL-K functions are VERY fast when .AFX-files
          are being searched (as opposed to standard ASCII text
          search): ARV will search about 5 .AFX-lists per second!
L         \Re-read directory~
N         specify \archive name~. See ARV.DOK, option "altf1..altf10"
          to learn about its use.
W         followed by A..Z: \choose drive~. Use this function to
          select drives outside the range A..H.
Z         \Show file~ contents. You won't like the built-in lister.
          Install your own using the \zeigedatei~ option.

<Tab>     Select display mode for \last screen line~:
            - AlternateF1..F10 dos command comments
            - ShiftF1..F10 path comments
            - comment for actual file
           If you have enabled automatic selection (neu_info_modus=-1),
           this key doesn't do anything.

CTRL-P    append \file type proprietary information~ to file comment.
          For example, you can append size and/or number of colours
          for GIF files.

CTRL-Q    \Quick Quit~ ARV.

CTRL-S    or F9 : jump to \DOS-Shell~, use "exit" to return to ARV.

°Cursor movement

CTRL-PgUp jumps to top of directory
CTRL-PgDn jumps to bottom of directory

°Marking/unmarking files

Ins
Einfg
<Enter>   \mark file~ or jump to sub-directory
#         \reverse selection of files~
-         \unmark all files~

°On the numeric keypad:

Plus      \mark~ multiple files
Minus     \unmark~ multiple files
X         \toggle mark state~ of multiple files
/         Special functions:
          - mark all files that are already in the ARV catalog
          - unmark all files that are already in the ARV catalog
          The files are compared according to the setting of
          neu_datei_vergleich.

°Create/undo file linkage:

P        select \primary file~

V        \link file~ to primary file (the one you selected using P)
U        \unlink file~


°Misc:

F2       view \statistics~

F3       \ARV configuration~.
         Not all options can be changed there.
         There are more. Please consult ARV.DOK for a full listing.
@TextEingabe
°How to enter text

If the first key pressed is no cursor positioning key, the
preset text in the entry field will be erased. It can be restored at
any time by pressing <Esc>.

use:

<-,->     to move the cursor
          Hold down CTRL to jump over words.

<Enter>   to accept text entered

CTRL-Y    to clear text

Pos1      jump to start of text

Home      jump to end of text
@GruppeAuswaehlen
You have to choose a group for this file.

Choose a group using the cursor keys, hit \<Enter>~ to confirm
choice.
Hit \<Esc>~ to skip this file.

°New group

If the file does not fit in any group, you can create a new group
by pressing "\N~".

If you want this file to be copied to a predetermined disk, you
can choose a disk from a list you reach via "\D~"

Misc:

E        Edit group

CTRL-S   or F9 : jump to \DOS-Shell~, use "exit" to return to ARV.

F2       view \statistics~

F3       \ARV configuration~.
         Not all options can be changed there.
         There are more. Please consult ARV.DOK for a full listing.

CTRL-F1  \identify disk~ - Display the ARV ID of any disk
@DisketteAuswaehlen

Select the disk to put this file on.

NOTE:
      You may assign the file to a locked disk.

      It is possible that, when it comes to copying the file,
      the disk does not have enough free space anymore, because
      ARV has already put other files on it.
      You can work around this problem if you set the "disk lock"
      flag before selecting the disk.

To go back to the "select group" page, press \<Esc>~.

Misc:

CTRL-S   or F9 : jump to \DOS-Shell~, use "exit" to return to ARV.

F2       view \statistics~

F3       \ARV configuration~.
         Not all options can be changed there.
         There are more. Please consult ARV.DOK for a full listing.

CTRL-F1  \identify disk~ - Display the ARV ID of any disk

CTRL-F7  \Lock/unlock disk~.
         No more files will be put on this disk by ARV.
@Statistik
°Top left

These figures are easy to decipher.
φ means "mean".

°Top right

The "holes" in the database are entries that have been freed because the
file/disk/group has been deleted. If "turbo_files" is off, these holes
will be filled as soon as possible. For further explanation, please
consult arv.dok ("turbo_files").

The cache figures denote the hit percentage of the built-in caches for
the files FILES.ARx, DISKS.ARx and FILES.ARx.

Similary, the ARV.OVR-Load/Trap describes how frequently overlayed
modules had to be reloaded from ARV.OVR. The lower, the better.

°To the lower left

°These values are valid only if "statistics" has been called at least
°twice.

\Entries/second~ is a measure for the mean access speed to the database.
ARV gets rather slow as more as more files are in the database.
Use ARV_OPTI from time to time to improve it considerably.

The \performance index~ does not depend that much on the size of the
database and should be useful to compare the program speed under
different environments.

This value can be adjusted to 1: Read current value, then add line
\lindex_divisor~=value to ARV.CFG.

°And, last but not least:

When you are a registered ARV user, your serial number and user name
is displayed.
If you are not registered, the date of the start of the evaluation
period is displayed. Please send in your registration form in time!
@DiskAnforderung
Please insert the requested Disk into the appropriate drive.

Should ARV assume the \wrong drive~, you will have to abort here and
change the drive for this disk using E in any disk list.

If you don't have the disk at hand, skip this disk with \<Esc>~.
@Ergebnis
These are the results of the "addition of files" run.

°The meaning of the letters behind the file names:

\K     ~The file has been successfully copied.
\k     ~The file has \not~ been copied.
      Either you did not assign the file to one of the groups,
      or you have refused to insert the required disk.
\V     ~The file has been linked to another file.
\v     ~The file was marked for linkage, but has not been linked.
      The reason might be that the primary file for this one has
      not successfully been added to ARV.
\H     ~This file has successfully been added as a primary file.

°What you can do now:

If you have define a DOS-Command to be executed after each addition
of new files (option \nach_aufnahme~), it will be activated when
you press ~<Enter>\. You can skip that by pressing \<Esc>~.

If the source directory was on a \hard disk~, you can now change the
"deletion mode" for the files listed here by pressing \L~. By default,
no files will be deleted. You may select that:

    - no file will be deleted

    - all successfully added files (marked with a "K") will be deleted

    - all files in this list will be delted (i.e. the ones that have
      not been copied will be lost) \CAUTION~ with that!
@DiskKomplett
You can add a whole disk to the chosen ARV group. A new DISK ID will
be created for this disk that will be written to it.

All files on this disk will be members of this group. You can save
a lot of time by adding a whole disk instead of adding the
files one by one.

The disk to be added should not already be an ARV disk, otherwise
you will be warned about it and asked for confirmation (it may
be an ARV disk you have copied from someone else, and to add
this one is permitted, of course).
@VerbundeneDateienLöschen
When you delete a file that is \linked to~ some "primary" file, but is
not the primary file itself, it will be removed from the chain. The
remaining files will be left linked.

When you delete the "primary" file of a group of linked files,
the remaining files will be linked to the first files linked to the
primary file. This one will become the primary file then.
@NeueDiskEinrichten
ARV needs a \new disk~ to put files to be added on.

The disk you are required to insert in drive A oder B has to
be \formatted~ and must not be an ARV disk. It will be emptied by
ARV without asking.

Use \CTRL-S~ to jump to a \dos-shell~, e.g. if you have got to format
a disk.

If you don't have an empty disk, you have to cancel adding the
current file using \<Esc>~.
@Kopierfehler
An error has occured while copying the file.

The reason is given by ARVCOPY via a three-letter code in the top left.

    MEM   : Buffer memory >10k could not be allocated
    FND   : Source file could not be found
    GRO   : Source file size could not be determined
    QUE   : Source file could not be opened
    ZIE   : Target file could not be opened
    LES   : Error reading from source file
    SCH   : Error writing to target file

Hit \<Esc>~ to abort.
Hit \<Enter>~ to tell ARV to try again.
@EditDiskId
You may edit the ARV disk id.
ARV doesn't care what name you give to the disk, though it is
advisable to use the name ARV proposes when creating a new
ARV disk:

The short group description, followed by a serial number.
@EditDiskAblage

You may attach a note to that disk, describing where you keep it,
e.g. "Box 5", "Upper shelf" etc.
@EditDiskLaufwerk
ARV will expect this disk to be in this drive.

You may have to change this setting, if

 - you copy a disk from 5.25" to 3.5" format, thus requiring it to
   be put into another drive.

 - you change your computer's configuration.

in the first case, you should use the special function "re-read
free disk space" to make sure this value is correct.
@KeinPlatzFuerKommentare
When the describe_arv-option is enabled, some disk space is required
for the comments that are written to the descript.ion-file on the
ARV disk.

If the disk has been filled with this option being disabled, it may
happen that there is not enough space to write the comments.

You should delete a small file and rewrite the comments using
the "special functions".
@KommentarNachfrage
You have enabled the option \kommentarnachfrage~, and ARV is just
doing what you asked it to do:

Please confirm this file comment by pressing J, make ARV
search for another comment by pressing N.
@FilesBbsGehtNichtAuf
ARV tried to open a file you have declared as a \files_bbs~ file
in ARV.CFG.

The read access failed. Most probably, the file does not exist at all.
If you don't want this error message, see ARV.DOK, option
"files_bbs".
@AfxGehtNichtAuf
ARV tried to open the given AFX - file

      a) you have declared as as \files_bbs~ file in ARV.CFG
  or  b) ARV has found in the directory given by the option \afx_verz~
         in ARV.CFG
  or  c) that corresponds to a text file you have declared as
         a \files_bbs~ file in ARV.CFG

to search for a file comment using the quick search.
The read access failed. Most probably, this file does not exist at all.
If you don't want this error message, see ARV.DOK, option
"files_bbs".
@ArvDiskAufnehmen
The disk you want to add to ARV does already have a DISK.ID file on it.
It may be one of your ARV disks.

If this is no ARV disk of yours, you may ignore this warning.
Remember however, that the disk will be given a new id, thus overwriting
the old disk.id file.
@FremdeArvDiskAufnehmen
The disk you want to add to ARV does already have a DISK.ID file on it.
The disk.id does not match any ARV disk of the current partition.

Maybe one of the following circumstances is true:

 a) It is one of your ancient ARV disks, and you have removed it
    with the special function "remove disk", thus keeping the
    DISK.ID-file on the disk.
 b) This is not your ARV disk at all.
 c) This is one of your ARV disks, but one of a different partition.

If this is no ARV disk of yours, you may ignore this warning.
Remember however, that the disk will be given a new id, thus \overwriting~
the old disk.id file.
@ProgrammBeenden
How could I help you with that?

ARV can be quick quit at most times with \CTRL-Q~.

This message is not displayed then.
@ToeteDisk
Use this function to \remove a disk from the ARV catalog~ that has
been lost.

It works similary to "L" - delete disk, but ARV will not try to remove
the DISK.ID file from the disk.

If you still have the disk, you should rather use this way, because
a DISK.ID-file left on a non-ARV disk may lead to some misunderstandings.
@DelDisk
This is the normal way to \remove a disk from the ARV catalog~.

ARV will request the disk to be removed, and delete the DISK.ID file
that marks the disk as an ARV disk.

ARV will not delete any files on the disk.

If you cannot insert the disk, for example, because you have lost it,
you can get rid of the disk using one of the "special functions"
(CTRL-F10).

You should however use THIS function, because a DISK.ID-file on a non-
ARV disk may lead to some misunderstandings.
@NichtleereDiskLoeschen
This disk you have chosen for removal contains ARV files.

When you remove this disk, all files on it will be removed, too.
@ZielDiskEinlegen
Please insert the disk you want to retrieve the files to.

You have already given ARV the full path to copy the files to.
If any of the subdirectories do not yet exist, they will be created.

If the target drive is a non-removable drive, you should add it
to the "festplatten" list in ARV.CFG.
@KeinPlatzZumPuffern
The files to be retrieved could not be buffered in the temporary
directory; there is \not enough space~ on the drive.

What can you do?

   - make more room on the drive the "\tempdir~" - directory is on.
   - set the "\tempdir~" option to a directory on a drive with
     enough free space.

Remember: The temporary directory must not be located on a
          removable media.
@DateiLoeschen
If you confirm the operation now, the chosen \file will be deleted~,
that means

  a) it will be deleted from the ARV disk

  b) it will be removed from the ARV catalog
@ZeigeKannNichtOeffnen
The ARV file show program did not manage to open the (existant!)
file.

Maybe you are using ARV in a network and someone else has the file
locked for exclusive use?

By the way; You should replace the ARV file show program by your
            favourite file lister.
            Consult ARV.DOK (option "\zeigedatei~") on how to do it.
@TipsHolenUndLoeschen
┌─────────────────────────────────────────────────────────────────────┐
│                     \Retrieval with deletion~                         │
└─────────────────────────────────────────────────────────────────────┘

This function will work in the same way as file retrieval, except that
files retrieved will be removed from ARV.

This is very useful, if you want to move several files to other
ARV groups:

- mark all files to be re-grouped.
- acticate \retrieval with deletion~ and retrieve all these files
  to a directory somewhere on your hard disk.
- re-add the files to ARV in the normal way.

Please do not confuse "\retrieval~" and "\retrieval with deletion~"!
Both functions use the same routines and look very similar.

It is not advisable to retrieve the files to removable media in
this operation, as the files will be deleted after they have been
copied to the temporary directory for buffering. If the process is
aborted now and the files have not been copied to the target
directory, you may lose them as ARV wipes the temporary directory
from time to time...
@FehlerHolen
On error has occured while copying the file from the ARV disk.

The reason is given by ARVCOPY via a three-letter code in the top left.

    MEM   : Buffer memory >10k could not be allocated
    FND   : Source file could not be found
    GRO   : Source file size could not be determined
    QUE   : Source file could not be opened
    ZIE   : Target file could not be opened
    LES   : Error reading from source file
    SCH   : Error writing to target file

@FehlerHolenLoeschen
For some reason, the file could not be deleted from the ARV disk.

ARV cannot tell you why the write access has failed. Perhaps you refused
to remove the write protection of the disk.

The file has not been removed from the ARV catalog.
@MarkiertStatusLoeschen

°Remove the "marked" state of all files

ARV is keeping track of marked files in to ways:

All files marked are kept in a list. This is necessary to allow fast
access on all marked files.
All files marked carry a special "marked" flag. This way, ARV can
show you the files marked in the file lists (■) without searching the
"list of marked files" for each file.

When you quit ARV, all of the "marked" flags will be removed.

When ARV is terminated abnormally, e.g. when a "runtime error" occurs,
the "marked" flags will not be removed. This way, files may have the
"marked" state without actually being marked.

This function will clear alle "marked" flags.
@DateiDoppelt

A new file is going to be added to ARV.

ARV has found a file already in the ARV catalog, that

  a) looks like if it was the same as the new one,
     perhaps just packed using another packer etc.

  b) looks like if it was the same as the new one,
     maybe just another version of the file (e.g. new: XYZ122.ARJ,
     old: XYZ119.ARJ)

You may now
 - delete the "old" file, taking the new one instead
 - decide not to add the new file, just keeping the old one
 - decide to keep both files.

If you choose \0~ to stop checking for duplicates of this file,
the new file will be added.

You can switch of the automatic version number check by setting
"\doppelt_version~" appropriately. Please check ARV.DOK.
@PfadNichtGefunden
The path given by you could not be located. Maybe the drive
specification is invalid.

If the drive is valid, ARV can try and create the given path.
@DateiKommentar_Aufnahme

Entering the \file comment~ for new files to be added

When adding a lot of files, it happens frequently that some of
the files already have comments assigned to them, e.g. from a 4DOS
descript.ion file that may have existed from the start or that you
have written in the file requester using CTRL-D.

You wouldn't like to confirm each of these comments one by one.

ARV offers you two ways to avoid that:

If \CTRL-A~ is pressed instead of <Enter>, ARV will not offer
File comments for confirmation for the rest of this "addition run".
ARV will, however, ask for comments for files without any comment.

\CTRL-G~ does much the same, but returns to normal operation after
the files for the actual group have been processed.
@DiskAnforderungBeiAufnahme
Please insert the requested Disk into the appropriate drive.

Should ARV assume the \wrong drive~, you will have to abort here and
change the drive for this disk using E in any disk list.

If you don't have the disk at hand, or don't want to add this file
to ARV anymore, skip this disk with \<Esc>~.

To \completely abort~ the addition process, press \CTRL-X~.
@ID_DiskIDzuhoch
Please note that this may be an ARV disk of yours that belongs to
another partition.
ARV can not distinguish that, as the partitions are independant from
each other.
@ID_IstFestplatte
If you have indeed pressed a letter belonging to a disk drive,
you misconfigured the option \festplatten~ in ARV.CFG, which tells
ARV which drives are non-removable.
Please consult ARV.DOK for further explanation.
@ID_DiskIDfrei
Please note that this may be an ARV disk of yours that belongs to
another partition.
ARV can not distinguish that, as the partitions are independant from
each other.
@ID_Diskbekannt
This DISK.ID is known in this ARV partition.

Please note that the disk may as well belong to another ARV partition.

ARV can not distinguish that, as the partitions are independant from
each other.
@CAD_Groesse
Changing the file size of course affects the total size of the group
it belongs to.
ARV of course took account of that, but how could the file size have
changed?
To make sure the group size is correct, please execute ARV_SOS.
@DiskspecNoRoom
There is not enough free space on this ARV disk for the file to be
added, along with file comments that might be stored on the disk, too.
@KommentarPlatzKompletteDisk
The disk you are going to add to ARV is nearly full.
If you sometime assign comments to all the files on this disk,
there will most likely be not enough space to write them to the disk.
@K_afx_verz
If you specify a path here, ARV will search all .AFX-files in this
directory to obtain file comments.

Only if the search in all these files fails, ARV will search the
files given by "files_bbs" options.

File commments are searched for for files to be added that don't
have a comment, or by pressing K or CTRL-K in the "addition" file
requester.
@K_alternative_liste
ARV normally display file name, file size, file date, ARV disk and
the file's group in all file lists.

Alternatively, you may have displayed the file name and its comment.

The display mode can be changed by <Tab>.

To set the default mode, use the option "alternative_liste":

 alternative_liste on

selects file comments

 alternative_liste off

selects normal display mode.
@K_belegung_bequem
ARV automatically selects an appropriate disk for files to be added
to the ARV system.
The disk is selected by the algorithm chosen by the \strategie~ option.

However, it may occur that, as a file is to be added, by chance
a disk just has been inserted which belongs to the same group as the
new file and has enough free space to carry the file.

The selected algorithm may choose a different disk for the file, which
would require an extra disk change.

To avoid that, thus saving time, you may state that ARV should put
the file on the disk already in the drive. This may not coincide with
the "strategie" algorithm selection, but what the heck?

  belegung_bequem on

  selects the "lazy" behaviour

  belegung_bequem off

  selects "proper" disk selection
@K_dkf
Please give the letters of all your 3.5" drive, so that ARV
can display the correct pictures with disk requests.
@K_selbegruppe
When you already link files to be added in the file requester (where you
select the files to be added), you usually would like to have the
linked files to belong to the same group as the primary file.

Give "selbegruppe on" to make ARV always put the linked file into
the same group as the primary file.
@K_strategie

Here, you select the algorithm ARV uses to select the appropriate disk
for a new file to be added to the ARV system.

 Possible choices:

           0 : "\Best fit~" - the file will be assigned to the disk
               which will have the least space remaining after the file
               has been copied to it.
               This strategy will result in the most "disk jockey" work,
               requiring the most disk changes.
               ARV disks will be used in a most effective way,
               leaving as least space as possible.
               This is the default algorithm.

           1 : "\First fit~" - The file will be assigned to the FIRST
               disk that has enough free space on it.
               This means, disks will be filled in the order
               "Tools 1", "Tools 2", "Tools 3" etc.
               This effectively results in disks with lower serial
               numbers being filled as soon as possible.

           2 : "\Last fit~" - The file will be assigned to the LAST
               disk that has enough free space on it.
               This means, disk will be filled in the order
               "Tools 7", "Tools 6", "Tools 5" etc.
               Using this method, newer files will be found on disks
               with higher serial numbers.

          NOTE:   No new disk will ever be created if there is enough
                  space on one of the disks belonging to the file's
                  group.
@K_datei_vergleich

When using the "swapping files" fuction, ARV compares "your" and
"the other one's" files to determine the file new to you.

datei_vergleich specifies when two files are considered to be the
same.
         0 tells ARV to ignore file size and file date. Two files
           are considered to be the same if they have the same
           name.
         1 tells ARV to take the file sizes into account, i.e.
           two files will have to be of the same size and of the
           same name to be considered as being identical.
         2 tells ARV to take the file dates into account.
         3 tells ARV to take both file size and file name into account.

The default setting is 3, not to allow you to miss any file.
@K_describe_arv

This option controls wether ARV files will be equipped with 4DOS
comments in a 4dos style descript.ion file on the ARV disks.

Please leave this option "on".

Should your *.AR? files should get corrupted, your file comments will
be lost if you have not enabled it. With "describe_arv on", you simply
can re-read all your disks' contents using the "add whole disk"
special function.

The only (minor) drawback: Less space will be on the disks for ARV files,
as the comments will be stored on them, too. However, usually, they use
up just a few hundred bytes.

If this option used to be on, and you switch it off, the existing
descript.ion comments files will be removed from the ARV disks in the
future.

You do not have to worry that the comments on the ARV disks could
be different from the comments kept resident by ARV: As soon as
a file comment is being changed, the disk will be marked with the
"K" flag to signal that the file comments need refreshing. The
desription file will be re-written as soon as possible (e.g. the disk
is inserted into the drive because files are to be retrieved).
@K_describe_geholt

This option controls whether retrieved files will be equipped with 4DOS
comments in a 4dos style descript.ion file.


   on   : as files retrieved have a 4dos style comment (i.e.
          in the same directory, a file named "descript.ion" will
          be created that holds a short description of the file)
   off  : the above will not be done

When you are using 4DOS, you should of course set (leave) this option
"on".

However, it is a very interesting thing for non-4dos-users, too:
When retrieving files for someone to take them with him who also
uses ARV, the comments will be read by the other ARV system.
The comments will, of course, be lost when the file is being copied
by the standard dos (not 4dos) "copy" command.
@K_doppelt_version

°Enable/disable file version checking

When a new file is going to be added, ARV checks if this file
already exists in the ARV catalog.

You may also let ARV check if there is already another version
of the file. This is controlled by this option.

ARV compares the file names to decide if the files are to be
considered the same or not.

Files are compared this way:

ARV searches for a numerical digit from the fourth position on.
If any are found, and less than two characters are following, the
file name is cutted off at the position of the digit.

Both file names will be treated this way. The files will be considered
to be the same if the remaining strings are the same.

Some examples:

      "ARV1_23" == "ARV1_24"
      "4PRINT2" == "4PRINT3"
      "4PRINT2" <> "5PRINT2"

When this option is turned on, and a new to be added file's name
matches any other of the existing files' names, it will be presented
to you in the same way as if exactly this file was found in the ARV
data files.

When "doppelt_version" is turned off, ARV will only warn you if the
file name you are going to add exactly matches the name of a file
already in the ARV catalog.
@K_druckertest

"druckertest" selects wether ARV will check if the printer is ready
before printing.

This only works with parallel printers. If you are using

  - a printer connected to one of your serial ports

  - a network printer

you should set it to "off".
@K_druckerport

If you have set "druckertest" to "on", you have to set the parallel
port you are printing to with this option.
E.g. use druckerport=2 to tell ARV the printer is connected to LPT2:.

To achieve high compatibility, ARV does not print directly to this
port, but to the PRN device. Thus, this option is only required to
provide ARV with the information necessary to be able to check if
the printer is ready.

The default setting is "\druckerport=1~".
@K_kommentarnachfrage

By default, ARV will ask you for confirmation when it has found
a file comment by searching any file list.

You may choose that you will always accept the first comment ARV
finds, and set

  \kommentarnachfrage off~

There is an exception, however, if you have specified a directory
to search for .AFX-files (option \afx_verz~).
ARV will always scan for comments in all of the .AFX-files in this
directory before presenting a list of all comments found. The
AFX file search method is fast enough to permit this behaviour.

@K_lange_arv_kommentare

~lange_arv_kommentare = ... \

            on : Full length comments (79 chars) will be written to
                 4dos-style-descript.ions on ARV disks.
                 4DOS below version no. 4.0 will be confused by this.

           off : The comments written to the descript.ion files
                 on the ARV disks will be truncated to 40 chars.

This option is ignored if \describe_arv~ is set to \off~.
@K_lange_hol_kommentare

The same as for \lange_arv_kommentare~, but for 4DOS-style
descript.ions written during file retrieval.

This option is ignored if \desribe_geholt~ is set to \off~.
@K_markbymail

Anything you specify here will be the default file name preset
when invoking the \MarkByMail~ function.

Please consult the manual ARV.DOK to learn more about the markbymail
function. It is used to automatically mark files listed in a text
file.
@K_maxlines

maxlines determines which video mode ARV should run in

    yes : use 43(EGA)/50(VGA) line mode. Switch back to 80x25
          on exit.
     no : use 80x25 mode.
   auto : Do not change video mode. ARV will use the currently
          active video mode.

If you are not using a VGA/EGA adapter, you should select "yes".
@K_nach_aufnahme

You want to keep a list of files you have added recently?
You want to send a list of new files each time you add them to ARV?

nach_aufnahme specifies a DOS command to be executed after any files have
been added to the ARV catalog. Please give the complete path to the
command, too (unless, of course, the command is DOS internal, e.g.
COPY).

Prior to executing the nach_aufnahme command, ARV will write the
file "\AUFNAHME.TXT~" to the ARV data directory. AUFNAHME.TXT is
a text file containing information about added files, one on each line.
By default, the file's name, length, date and comment are listed.
The file format can be chosen freely via the "AUFNAHME.CFG" config file.
Refer to ARV.DOk for further details.
@K_neu_datei_vergleich

This option works just like "\datei_vergleich~", bu it refers to how are
files being compared when using the "mark all files already in ARV"
and "unmark all files already in ARV" in the "Add new files" file
requester.

         0 tells ARV to ignore file size and file date. Two files
           are considered to be the same if they have the same
           name.
         1 tells ARV to take the file sizes into account, i.e.
           two files will have to be of the same size and of the
           same name to be considered as being identical.
         2 tells ARV to take the file dates into account.
         3 tells ARV to take both file size and file name into account.
@K_neu_info_modus

neu_info_modus defines what is to be displayed in the last screen line
in the "adding new files" file requester.

neu_info_modus can take one of the following values:

                   -1 - automatic: Display file comment, but switch to
                        appropriate display when shift or alt
                        is held down.
                    0 - Display Altf1..Altf10 dos command function
                        key comments
                    1 - Display Shiftf1..Shiftf10 path function
                        key comments
                    2 - Always display file comment

The default value is -1, and there should be no reason to change it.
@K_ppp_aufdisk

If you have selected file comment display using "alternative_liste"
(please look at its help page), you can choose what to do with
files without comment:

select

"ppp_aufdisk yes"
to make ARV display the id of the disk the file is archived on.

"ppp_aufdisk no"
to leave the comment space blank.
@K_s_swapping
s_swapping controls if ARV will try to swap itself out of precious
low memory (lower 640k) when you are "shelling to DOS".
Remember: The DOS shell is invoked by pressing CTRL-S or F9.

     on:  ARV will try to swap. It will swap to EMS, if available, or
          to a file named "ARVxxxxx.$$$" in the ARV.EXE directory.
          xxxxx will be 5 digits 0-9. This file has the "hidden"
          attribute set, so you won't see it using dir, but
          using attrib.
          This way, ARV will occupy only about 5000 bytes.
     off: ARV will not try to swap. On systems with slow disk access, this
          will save you time if you don't have EMS.
@K_swapping
This option decides wether ARV will swap itself out of memory when
a DOS command is executed. This may be the "nach_aufnahme" DOS command,
or a command activated by pressing "Alt-.." in the "add new files" file
requester.

Please consult the help page to "\s_swapping~" on how to use "swapping".
@K_zeigeverbund

As you know, you may link files together that belong together or
are useless one without the other.

You may then wish that only the first of the linked files (the "primary
file") should be displayed in the ARV lists.

zeigeverbund nein

does exactly this.

Use \<Shift-Tab>~ to change the display mode temporarily.
@K_turbo_files

When entries in the GROUPS.ARV, DISKS.ARV & FILES.ARV data files are
being deleted, the are kept free until a new group, disk or file
(respectively) are created. ARV then searches for the next free
entry and uses it to store new data.

When adding files, this may be lengthy, because ARV will have got to
search the whole FILES.ARV for free entries.
Of course, this approach serves space by re-using the entries
freed once.

You may speed up the addition of files by setting "turbo_files on".
With "turbo_files" enabled, ARV will not look for unused entries, but
append the new entry to the end of FILES.ARV.

This works much faster, but the FILES.ARV size increases much faster,
because of the "holes" not being filled.

Use ARV_OPTI to optimize FILES.ARV from time to time.

The default setting is "turbo_files no".
@K_toddlkomm

The name of this option might sound a bit strange, it originates from
the name of the beta-tester who by any means needed this function.

  on/yes : When asking for text entry, always use last input as
           default.
  off/no : Don't do it.
@dsfFreienPlatzEinlesen

°reread free disk space

Re-read free space on disk.

Apart from that, ARV re-reads the cluster size, i.e. the smallest
unit that can be allocated.

Use this function after moving the contents of an ARV disk to another
disk, e.g. from 5.25" to 3.5".

ARV then needs to know about the changed figures.
@dsfRefreshComments

°rewrite comments

As the name suggests, the comments of the files on this ARV disk are
rewritten. Note that the comments are only written to disk if
describe_arv is set. If this option is unset, ARV will erase the
descript.ion file on this disk.

Normally, this function should not be needed, as ARV automatically keeps
track on which komments have been changed and have to be rewritten.
@dsfDiskSperre

°lock/unlock disk

Toggle "locked" state of disk.

This disk will will be no more looked at when selecting a disk for
a new file.
@dsfCheckDisk

°disk check

Compare the ARV data against actual disk data.

ARV checks if there are exactly the files on the disk that ARV
has stored in his data files.

If any files are missing either on the disk or in the ARV catalogue,
this will be corrected.
@dsfDiskIdSchreiben

°write DISK.ID file

You may let ARV write the id of the selected disk anywhere you like.

Use this function if the DISK.ID file of any ARV disk has been corrupted.
@fsfDateienTauschenFunktion

Please consult ARV.DOK on how the "Swapping of files" function
works. There is a seperate chapter dealing with it.
@fsfMarkByMailFunktion

°MarkByMail - function
─────────────────────

ARV will request the name of a text file.

This file will be treated as a list of file names, i.e. all file names
have to start at the same column.

All files in this list will be marked.

Imagine you have set ARV to automatically send a list of new files to
all your friens via electronic mail each time you add new files to the
ARV system. Your friend edits the list and saves it to disk.

He walks over to you with the disk, activates MarkByMail and
schwupp-di-wupp (as we germans say for "in no time") he has the
files marked in your ARV system and retrieved to his disk.
@fsfMarkiertStatusLoeschen

°Remove the "marked" state of all files

ARV is keeping track of marked files in to ways:

All files marked are kept in a list. This is necessary to allow fast
access on all marked files.
All files marked carry a special "marked" flag. This way, ARV can
show you the files marked in the file lists (■) without searching the
"list of marked files" for each file.

When you quit ARV, all of the "marked" flags will be removed.

When ARV is terminated abnormally, e.g. when a "runtime error" occurs,
the "marked" flags will not be removed. This way, files may have the
"marked" state without actually being marked.

This function will clear alle "marked" flags.
@fsfDateiEntfernen

Just as the "Remove disk" function will remove a disk from ARV without
requiring the disk, this function may remove a file from the
ARV catalog without requesting you to insert the disk it is on.

It should be rarely needed.

Use with caution!
@Ende